<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
<TITLE>IBM Visualization Data Explorer Programmer&#39;s Reference</TITLE>

<META HTTP-EQUIV="abstract" CONTENT="IBM Visualization Data Explorer
Programmer&#39;s Reference">
<META HTTP-EQUIV="contact" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="owner" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="updated" CONTENT="Tue, 16 Sep 1997 ">
<META HTTP-EQUIV="review" CONTENT="Fri, 14 Aug 1998 ">

<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF">

<A NAME="Top_Of_Page"></A>
<H1>IBM Visualization Data Explorer Programmer&#39;s Reference</H1>
<B>&#91; <A HREF="#Bot_Of_Page">Bottom of Page</A> &#124; <A
HREF="progu306.htm">Previous Page</A> &#124; <A HREF="progu308.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B><HR><P>
<H3><A NAME="HDRDXSCV" HREF="progu097.htm#PToC_401">DXSetComponentValue</A></H3>
<A NAME="IDX2056"></A>
<A NAME="IDX2057"></A>
<P><STRONG>Function</STRONG>
<P>
Adds a component to a Field.
<P><STRONG>Syntax</STRONG>
<BR>
<TT><STRONG><BR>
&#35;include &lt;dx/dx.h&gt;<BR>
<P><BR>
Field DXSetComponentValue(Field f, char *name, Object value)<BR>
</STRONG></TT><BR>
<P><STRONG>Functional Details</STRONG>
<P>
Sets the <TT><STRONG>name</STRONG></TT> component of Field
<TT><STRONG>f</STRONG></TT> to
<TT><STRONG>value</STRONG></TT>.
If <TT><STRONG>name</STRONG></TT> is <TT><STRONG>NULL</STRONG></TT>,
<TT><STRONG>value</STRONG></TT> can be accessed only by
<TT><STRONG>DXGetEnumeratedComponentValue</STRONG></TT>.
If <TT><STRONG>value</STRONG> </TT> is <TT><STRONG>NULL</STRONG></TT>, the
<TT><STRONG>name</STRONG></TT> component will be deleted.
<P>
When <TT><STRONG>DXSetComponentValue</STRONG></TT> overwrites an existing
component, all attributes associated with the prior value are
copied to the new <TT><STRONG>value</STRONG></TT> and they
supersede any attributes already attached to the
new <TT><STRONG>value</STRONG></TT>.
If this result is not the one desired, the earlier component value
should be removed prior to setting the new one.
<P>
Components of Fields are typically Arrays and contain geometrical and
topological information and associated data.
These components are interrelated (e.g., an association of data with
either the points defined in the "positions" component or
the elements defined in the "connections" component).
Their relationships are specified through attributes, which should be
set as the components are inserted into the Field.
After all components are inserted, call <TT><STRONG>DXEndField</STRONG></TT>,
which will add any additional attributes (and ancillary components)
that are necessary.
<P><STRONG>Return Value</STRONG>
<P>
Returns <TT><STRONG>f</STRONG></TT> or returns <TT><STRONG>NULL</STRONG></TT>
and
sets an error code.
<P><STRONG>See Also</STRONG>
<P>
<TT><STRONG>
<A HREF="progu131.htm#HDRDXDC">DXDeleteComponent</A>,
<A HREF="progu163.htm#HDRDXGCV">DXGetComponentValue</A>,
<A HREF="progu168.htm#HDRDXGECV">DXGetEnumeratedComponentValue</A>,
<A HREF="progu251.htm#HDRDXNF">DXNewField</A>,
<A HREF="progu306.htm#HDRDXSCA">DXSetComponentAttribute</A>
</STRONG></TT>
<P>
<A HREF="progu044.htm#HDRFIELDSC">12.1 , "Field Class"</A>.
<P><HR><B>&#91; <A HREF="#Top_Of_Page">Top of Page</A> &#124; <A
HREF="progu306.htm">Previous Page</A> &#124; <A HREF="progu308.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B> <br><b>&#91;<a
href="../allguide.htm">Data Explorer Documentation</a>&nbsp;&#124;&nbsp;<a
href="../qikguide.htm">QuickStart Guide</a>&nbsp;&#124;&nbsp;<a
href="../usrguide.htm">User&#39;s Guide</a>&nbsp;&#124;&nbsp;<a
href="../refguide.htm">User&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../proguide.htm">Programmer&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../insguide.htm">Installation and Configuration
Guide</a>&nbsp;&#93;</b><br><p><b>&#91;<a
href="http://www.research.ibm.com/dx">Data Explorer Home
Page</a>&#93;</b><p><HR ALIGN=LEFT WIDTH=600><b>&#91;<A
HREF="http://www.ibm.com/">IBM Home Page</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Orders/">Order</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Search/">Search</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Assist/">Contact IBM</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Legal/">Legal</A>&nbsp;&#93;</b><hr><p>
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
